Add opt-in IEEE 802.11 Radiotap PCAP capture - #1130

Summary

Add protocol-specific PCAP capture adapters and an opt-in IEEE 802.11 Radiotap
adapter. Bare IEEE 802.11 DLT 105 remains the default; enabling both
enableProtocolSpecificCaptureAdapters and packet conversion selects DLT 127.

• Export available legacy, HT and VHT SU PHY metadata.
• Split typed A-MPDUs into MPDU records with deterministic inbound aggregate
  references; preserve malformed aggregates as whole-PSDU records.
• Keep wireless observation translation and WLAN-specific encoding outside the
  generic recorder.
• Write metadata prefixes and packet slices without allocating temporary packets.
• Honor finite PCAPng capture limits and preserve zero-as-unlimited behavior.
• Preserve existing packet-only writePacket overrides for filtering and
  replacement before adapter records are generated.

VHT MU, HE and EHT metadata remain outside this PR's scope.

The adapter preserves short-preamble metadata independently of FCS flags.
Tests cover request/indication tags and transmission precedence. The registry
exposes a single protocol-resolution operation used by the recorder.

Reading order

Architecture and compatibility

IPcapWriter gains writePacketWithPrefix(); custom implementations must
implement it. The migration guide documents prefix length semantics and the
PCAPng snaplen correction. PcapRecorder gains an opt-in NED parameter, and
.oppfeatures includes the wireless observation adapter package. No modeled
frame fields or MSG definitions change.

The existing packet-only PcapRecorder::writePacket hook runs once per selected
packet before adapter expansion, including when one A-MPDU produces several
records. Subclass filtering and replacement therefore apply to both plain and
Radiotap captures. Borrowed PHY context follows only the original packet;
replacement packets do not inherit it. Nested calls and exceptions restore the
previous observation context.

The PR touches the sealed src/inet/common/packet/recorder/ surface:
IPcapCaptureAdapter.h, IPcapWriter.h, PcapCaptureAdapterRegistry.{h,cc},
PcapRecorder.{h,cc,ned}, PcapWriter.{h,cc} and PcapngWriter.{h,cc}.
After the audit identified the sealed scope and the registry API correction, the
user requested “perform the corrections” and explicitly requested rewriting
the local commit messages and updating this description. That authorization
covers the named correction work; it does not remove the seal or substitute for
the repository's trusted, head-bound merge approval. Historical authorization
for the original sealed changes was not independently verified by this audit.
The subsequent legacy-hook correction in PcapRecorder.{h,cc} was also authorized
by the user after the finding and affected path were identified.

Scoped architecture checks found no new dependencies. Existing recorder
dependencies on node/interface abstractions remain covered by AV-ORG-01;
they have not been silently sanctioned or removed from the ledger.

Validation

The validated source is now committed at
6433d9e442f5abe7950c6d750f8c45516fcb4059, with tree
8a2979fa7fba28eddc522150fd175a4c497ead3e.
Run from the INET repository root, using OMNeT++ 6.4.0aipre2 and debug mode:

make MODE=debug -j8
MPLCONFIGDIR=/tmp/pr1130-matplotlib inet_run_unit_tests -m debug -f '(PcapCaptureAdapterRegistry|PcapRecorderFcsInd|PcapRecorderIeee80211Ampdu|PcapRecorderRadiotapHtVht|PcapWriterPrefix|PcapngWriterSnaplen|WirelessPcapCaptureObservationAdapter)_1\.test'
MPLCONFIGDIR=/tmp/pr1130-matplotlib inet_run_module_tests -m debug -f 'PcapRecorder(LegacyWriteHook|RadiotapRoundTrip)_1\.test'
git diff --check
doc/project/enforcement/check-architecture.sh src/inet/common/packet/recorder

• Debug build: PASS.
• Focused unit tests: 7/7 PASS, including long/short HR-DSSS preambles,
  independent FCS flags, both mode-tag types, and transmission precedence.
• Module tests: 2/2 PASS. The round-trip test covers recorder/read/replay,
  default capture and conversion-disabled DLT 105 behavior. The new signal-driven
  legacy-hook test checks invocation, suppression, replacement bytes and
  preservation of the original packet in both plain and Radiotap captures.
  It failed before the fix because the Radiotap path never invoked the override.
• The first four commits passed incremental debug builds and checks
  through the installed opp_repl API: respectively 1/1, 2/2, 4/4 and 7/7
  unit tests, plus 1/1 module test at 4189793955.
  Its exact commands and results are retained locally under
  audit/pull-request/pr-1130-evidence/corrections/.
• Commit-message and classification checks passed for the latest commit;
  whitespace checks passed for its patch. The first four commits also passed
  include and NED-parameter checks. The latest scoped architecture check reports
  four pre-existing node/interface includes under open AV-ORG-01; no new
  dependencies were introduced.

Legacy fingerprints

Run from tests/fingerprint:

./fingerprinttest -d -t 8 -m '/(showcases/general/pcaprecording|examples/inet/pcaprecorder|examples/wireless/ieee80211)/' -f tplx -f '~tNl' -f '~tND' -l /tmp/pr1130-hook-fingerprint-details.log
./fingerprinttest -d -t 8 -m '/examples/wireless/ieee80211levelofdetail' -f tplx -f '~tNl' -f '~tND' -l /tmp/pr1130-hook-wifi-details.log

10/10 cases PASS, with no fingerprint baseline changes:

• Two PCAP cases: examples/inet/pcaprecorder (General, run 0, 5000s) and
  showcases/general/pcaprecording (PcapRecording, run 0, 10s). The latter covers
  default-off IEEE 802.11 capture alongside Ethernet/PPP/IP and packet filtering.
• Eight IEEE 802.11 level-of-detail cases: Default and Layered configurations,
  distances 100/1000, bitrates 6/54, repetition 0, one simulated second each.

The first selector's examples/wireless/ieee80211 alternative matches no rows;
the second command supplies the eight WLAN cases. These runs compare tplx,
~tNl and ~tND, using the checked-in run/seed selection.

IEEE 802.11-disabled build

An isolated checkout containing the same recorder source passed a debug build
with Ieee80211 and its dependent features disabled. From that checkout's root:

source setenv -q
opp_featuretool disable -f Ieee80211
make MODE=debug -j8

The repository's feature smoke simulation also passed. From its tests/features
directory, with the isolated checkout's environment active:

inet --debug -u Cmdenv -n . -f omnetpp.ini -c General -r 0

The smoke test verifies library loading and initialization. An initial invocation
omitted -n . and could not find FeatureTest; adding the local NED directory
resolved that setup error.

Logs, normalized test results, source hashes and the disabled feature configuration
are retained locally under audit/pull-request/pr-1130-evidence/legacy-hook/.
Release compilation, the complete feature matrix and the full legacy Wi-Fi suites
have not been rerun for this revision; the fingerprint result above is scoped to
the ten named cases.